
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>GitDiagram如何让你的GitHub项目可视化 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>GitDiagram如何让你的GitHub项目可视化 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">使用GitDiagram可视化一个公开GitHub仓库最简单快捷的方法是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">最简单的方法是URL替换技巧：将目标GitHub仓库链接中的 “github.com” 替换为 “gitdiagram.com”。例如，将 `https://github.com/facebook/react` 改为 `https://gitdiagram.com/facebook/react` 即可。</div>
          </div>
          <div class="card-source">来源: 三、快速上手GitDiagram -> 1. URL替换技巧</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">GitDiagram是如何解析GitHub仓库并获取其结构的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">GitDiagram通过GitHub API获取仓库的完整结构信息，包括文件层次、提交历史和分支信息。它使用递归算法遍历整个仓库，从而构建出完整的文件依赖关系图。</div>
          </div>
          <div class="card-source">来源: 二、GitDiagram的工作原理 -> 1. 如何解析GitHub仓库结构</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">相较于GitDiagram，传统的文件树方式在展示代码结构时存在什么核心局限？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">传统的文件树方式虽然能直观展示文件层级，但它无法反映文件之间的依赖关系和调用逻辑，也无法展示项目的演化历史，而这些是理解复杂项目架构的关键。</div>
          </div>
          <div class="card-source">来源: 一、GitDiagram的诞生背景 -> 2. 传统代码结构展示方式的局限</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">在生成的可视化图表中，GitDiagram使用什么算法来布局节点，以确保关联文件在视觉上更靠近？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">GitDiagram采用力导向算法（force-directed algorithm）进行布局。这种算法能够确保相互关联或存在依赖关系的文件节点在视觉上被放置得更近，从而直观地展示模块间的关系。</div>
          </div>
          <div class="card-source">来源: 二、GitDiagram的工作原理 -> 2. 可视化图表的生成过程</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">如果需要使用GitDiagram访问私有GitHub仓库，需要完成哪些授权步骤？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">访问私有仓库需要三个步骤：1. 在GitHub上生成个人访问令牌（Personal Access Token, PAT）；2. 在GitDiagram的设置中绑定该令牌；3. 授权GitDiagram访问指定的私有仓库。</div>
          </div>
          <div class="card-source">来源: 三、快速上手GitDiagram -> 3. 私有仓库的访问设置</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">除了帮助新成员快速熟悉项目，GitDiagram在项目架构优化方面有什么高级应用？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">GitDiagram可以用于项目架构优化分析，它能够帮助识别项目中的潜在架构问题，例如循环依赖（circular dependencies）和模块间过度耦合（high-coupling）等。</div>
          </div>
          <div class="card-source">来源: 四、GitDiagram的高级应用场景 -> 4. 项目架构优化分析</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">GitDiagram与Git2Dot这两个工具在可视化的侧重点上有何不同？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">GitDiagram更侧重于可视化项目的代码结构和文件依赖关系，帮助理解项目架构；而Git2Dot则专注于Git的提交历史可视化，用于展示项目的演变过程。</div>
          </div>
          <div class="card-source">来源: 五、与其他代码可视化工具的比较 -> 1. GitDiagram vs Git2Dot</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">通过分析知名开源项目的可视化图表，我们可以获得哪些关于优秀项目设计的洞见？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">可以获得的洞见包括：1. 清晰的模块化设计；2. 存在少量的核心抽象概念（如Flask的应用上下文）；3. 依赖关系通常是单向的以避免循环依赖；4. 大多采用分层架构。</div>
          </div>
          <div class="card-source">来源: 六、知名开源项目的可视化展示 -> 4. 从可视化图表中获取的项目设计洞见</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">如何将GitDiagram生成的可视化图表集成到技术文档或教学材料中？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">可以通过HTML的`<iframe>`标签将GitDiagram的交互式图表嵌入到技术文档或网页中，让读者可以在文档内直接查看和操作项目结构图。</div>
          </div>
          <div class="card-source">来源: 四、GitDiagram的高级应用场景 -> 2. 技术文档与教学中的应用</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
